home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / utimes.man < prev    next >
Encoding:
Text File  |  1989-01-28  |  2.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. UTIMES                C Library Procedures                 UTIMES
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      utimes - set file times
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ##iinncclluuddee <<ssyyss//ttiimmee..hh>>
  13.  
  14.      uuttiimmeess((ffiillee,, ttvvpp))
  15.      cchhaarr **ffiillee;;
  16.      ssttrruucctt ttiimmeevvaall ttvvpp[[22]];;
  17.  
  18. DDEESSCCRRIIPPTTIIOONN
  19.      The _u_t_i_m_e_s call uses the "accessed" and "updated" times in
  20.      that order from the _t_v_p vector to set the corresponding
  21.      recorded times for _f_i_l_e.
  22.  
  23.      The caller must be the owner of the file or the super-user.
  24.      The "inode-changed" time of the file is set to the current
  25.      time.
  26.  
  27. RREETTUURRNN VVAALLUUEE
  28.      Upon successful completion, a value of 0 is returned.  Oth-
  29.      erwise, a value of -1 is returned and _e_r_r_n_o is set to indi-
  30.      cate the error.
  31.  
  32. EERRRROORRSS
  33.      _U_t_i_m_e_s will fail if one or more of the following are true:
  34.  
  35.      [ENOTDIR]      A component of the path prefix is not a
  36.                     directory.
  37.  
  38.      [EINVAL]       The pathname contains a character with the
  39.                     high-order bit set.
  40.  
  41.      [ENAMETOOLONG] A component of a pathname exceeded 255 char-
  42.                     acters, or an entire path name exceeded 1023
  43.                     characters.
  44.  
  45.      [ENOENT]       The named file does not exist.
  46.  
  47.      [ELOOP]        Too many symbolic links were encountered in
  48.                     translating the pathname.
  49.  
  50.      [EPERM]        The process is not super-user and not the
  51.                     owner of the file.
  52.  
  53.      [EACCES]       Search permission is denied for a component
  54.                     of the path prefix.
  55.  
  56.      [EROFS]        The file system containing the file is
  57.                     mounted read-only.
  58.  
  59.      [EFAULT]       _F_i_l_e or _t_v_p points outside the process's
  60.  
  61.  
  62.  
  63. Sprite v1.0            September 30, 1987                       1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. UTIMES                C Library Procedures                 UTIMES
  71.  
  72.  
  73.  
  74.                     allocated address space.
  75.  
  76.      [EIO]          An I/O error occurred while reading or writ-
  77.                     ing the affected inode.
  78.  
  79. SSEEEE AALLSSOO
  80.      stat(2)
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0            September 30, 1987                       2
  130.  
  131.  
  132.  
  133.